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Introduction 


Link sent out to the bioinfo-fika group with installation guidelines. 


https://sites.google.com/site/msInrm/bioinfofika/bioinfofikawed28febdocker 


This presentation is both an introduction to Docker, introduction to the principle and the benefits it 
brings to me as a ‘developer’, and a demonstrations of some key functionality (if you have 


docker&docker compose installed, you can tag along) — some exercises 


Why are we using Docker ? 


The immediate benefits would be. 


l. 


Itis easy to set up a complex project, someone has already packaged all the different 
software and dependencies ( with the correct version) for you. 


Deploying to Test and Production : You can guarantee the environments are the same! 
1. Makes debugging easier, you can spot problems on your local desktop 


For teams : Docker is cross-platform, your team-members can run on Mac, GNU/LINUX or 
Windows 


You don't have to clutter up your machine when you are testing different technologies 


1. if you are not happy, you stop the container and erase the image! 


The developer Toolbox 


We are using more tools than those below, only using CLI (Command Line Interface) 


These 4 tools are essential for our Docker-projects 


1. 


2 
3. 
4 


Most of us are running on OS=GNU/Linux 


. Docker and Docker Compose 


make ( Writing one or many Makefiles for each of our projects) 


Git-client (all source code on github.com) 


What is Docker 


Docker is a software for creating containerized applications. 
You need an Image to create a Container! 


The concept of a container 


“_... a lightweight, stand-alone, executable package of a piece of software that includes 
everything needed to run it: code, runtime, system tools, system libraries, settings. “ 


"Available for both Linux and Windows based apps, containerized software will always run 
the same, regardless of the environment" 


source : https://www.docker.com/what-container 


LIGHTWEIGHT 


Docker containers running on a single machine 
share that machine's operating system kernel; 
they start instantly and use less compute and 
RAM. Images are constructed from filesystem 
layers and share common files. This minimizes 


disk usage and image downloads are much faster. 


Images and Containers 


Two fundamental Concepts : Images and Containers. (‘Docker Images’ and ‘Docker Containers’) 
Metaphors, can be helpful .... The relation between an Image and a Container. 
1. The Blueprint and the actual Building .... 
1. Where the Blueprint is the Image and the Building is the container. 


1. You can use the Blueprint to create several Buildings ..... 


A concept : 1 application using 3 Containers 


The image below describes a concept. 


3 Containers ‘working together’ - running on the same machine (same kernel), each container has 
their own OS (Debian, Ubuntu and Alpine being Linux Distros) with different software installed. 


CONTAINER CONTAINER CONTAINER 


Tomcat PHP 


Java MySQL Static Binary 


Debian Ubuntu Alpine 


Kernel 


~ IIN ADT s pP Pl 1 


POS heit genti peti jm te 


source: https://www.docker.com/what-container 


The upside of using Docker 
For the Team 


The above take on what a container is. This makes it possible for each of us in the team to have 
different containers but identical. This will give us a homogeneous environment on the machines 
below. 


1. On All developers machines 
2. On the test-machine(s) 


3. On the production-machine(s) 


Docker is cross-platform, every single developer in the team will be working in the same 
environment. 


Both the DINA-project and in the BIOATLAS-project (BAS') are using Docker for Sharing 
/Distributing source code and Docker-images - we are using github.com and hub.docker.com. 


https://github.com/dina-web & https://github.com/bioatlas 


You need to be part of the above team(s) to be able to push source-code to github and to push 
images to docker-hub. Everybody can clone/fork code from github and pull images from docker 
hub. 


For the individual 
What are the benefits ? 
You don’t want to clutter up your machine, for instance install multiple 
How would you go about if you would like to test different database engines ? 
You would like to try 
1. MySQL version 5.7 , upgrade to version 8.0 
2. MariaDB version 5.5, upgrade to version 10.3 
We will get back to this setup, using the MySQL:s Sakila database 
the sakila-database : 
1. https://dev.mysql.com/doc/sakila/en/sakila-installation.html 


2. https://dev.mysql.com/doc/index-other.html (see Example Databases) 


Short about the ‘Docker Hub’ ? 
https://hub.docker.com/ 


‘Biodiversity Atlas Sweden (ALA = Atlas of Living Australia. ALA is a platform and a service : 
https://www.ala.org.au/) 


Using Docker hub. 
You don't have to register to be able to pull Docker-images from Docker hub. 


You need to register if you would like to save your Docker-images on Docker hub. 


“Docker Hub is a cloud-based registry service which allows you to link to code repositories, build 
your images and test them, stores manually pushed images .... “ 


1. You are able to register an organisation and store your images. 
2. You are able to register yourself [and be a part of an organisation] 
3. DINA and BAS 
1. https://hub.docker.com/u/dina/dashboard/ 
2. https://hub.docker.com/r/bioatlas/ 
Official repositories on Docker Hub 


“ The Docker Officials Repositories are a curated set of Docker repositories hosted on Docker 
Hub. They are designed to: 


© Provide essential base OS repositories (for example, ubuntu, centos) that serve as the 
starting point for the majority of users. 


© Provide drop-in solutions for popular programming language runtimes, data stores, and other 
services, similar to what a Platform-as-a-Service (PAAS) would offer. 


© Exemplify Dockerfile ‘best practices’ and provide clear documentation to serve as a 
reference for other Dockerfile authors. 


© Ensure that security updates are applied in a timely manner. This is particularly important as 
many Official Repositories are some of the most popular on Docker Hub. “ 


source https://docs.docker.com/docker-hub/official repos/ 
Example of officials repositories: 
1. Debian (official): https://hub.docker.com/ /debian/ 
2. Ubuntu (official): https://hub.docker.com/ /ubuntu/ 
3. Alpine : https://hub.docker.com/ /alpine/ 
4. ‘hello world’ : https://hub.docker.com/ /hello-world/ - for testing ..... 


1. Hello World! (an example of minimal Dockerization) 


Getting started 
To clarify the difference between CE and EE 


Community Edition (CE) vs. Enterprise Edition (EE) 


“Docker CE is available for free and is ideal for developers and small teams looking to get 
started with Docker to build container apps .... “ 


“Docker EE is a subscription of software, support and certification for enterprise dev and 
IT teams building and managing critical apps in production at scale. Docker EE is a 
Containers-as-a-Service platform ... " (Akronym: CaaS) 


source : https://www.docker.com/get-docker 


We will be using the Community Edition. 


Docker (DEMO — hands on) 
See part 3 : https://sites.google.com/site/msInrm/bioinfofika/bioinfofikawed28febdocker 


To test your docker installation (show): ( where *hello-world' is an Image at docker-hub) 


— The ‘hello-world’ image is an image just to control your docker-installation 


$ docker run hello-world 


What happens when you run the cmd ‘docker run hello-world’ ? 
1. If you have not the Image on your machine , the image is fetched from docker hub. 
1. Pulls — https://hub.docker.com/ /hello-world/ 
1. the image has the *latest'-tag ( see tag as ‘versions’) 
2. verify this by running the cmd ‘docker images’ 
2. Runs the container 
1. output : “Hello from Docker! 
This message shows that your installation appears to be working correctly" 
The ‘hello-world’-image is based on a special image called ‘scratch’ 


“Most Dockerfiles start from a parent image. If you need to completely control the contents of your 
image, you might need to create a base image instead." 


source https://docs.docker.com/develop/develop-images/baseimages/ 


Using and Exploring the bioatlas/mirroreum Docker Image. 


The pre requirement here is that you already downloaded the image. (around 5.35 GB ....) 
$ docker pull bioatlas/mirroreum 
1. Start the container ‘mywebide’ using the image ‘bioatlas/mirroreum’ (volume-mapping) 
$ docker run -d --name mywebide \ 
--env USERID=$UID | 
--publish 8787:8787 \ 
--volume $(pwd):/home/rstudio \ 
bioatlas/mirroreum 
2. Open rStudio in firefox (running on port 8080) — login rstudio/rstudio 
$ firefox http://localhost:8787 & 
3. Investigate which r-packages ? 
docker exec -it mywebide \ 


R --quiet -e “cat (rownames (instal led. packages 0)) " 


Read more 
here — https://hub.docker.com/r/bioatlas/mirroreum/ 


and here — https://github.com/bioatlas/mirroreum 


The Dockerfile (SHOW) : https://github.com/bioatlas/mirroreum/blob/master/Dockerfile 


Markus Skyttner is basing is basing his image on the ‘rocker/ropensci:3.4.1’-Image, then he adds a 
bunch of dependencies and R-packages + the shiny-server. 


Docker Compose (DEMO — hands on) 


]. Run a docker-compose.yml file with MySQL 
2. Runa docker-compose.yml file with MySQL and the Sakila-database 


Sidetrack 
Competing technologies, there are others 
https://www.infoq.com/articles/container-landscape-2016/ 
https://cloudacademy.com/blog/container-technologies-more-than-dockers/ 
git and github 
a git-client, not needed right now 
1. Do you have a github-account ? 
1. https://github.com/ 
2. Do you have a git-client ? (not needed right now) 
1. Git-client : https://git-scm.com/ 
3. Do you want to learn the basics ? 
1. “Got 15 minutes and want to learn Git?” 
1. https://try.github.io/levels/1/challenges/1 
For the curious - The Virtual Machine (VM) 


A virtual version of a real machine. It simulates the hardware of a machine inside of a larger 
machine. This means that you can run many virtual machines on one larger server. 


Virtual machines only works because of the Hypervisor, it is a special software that enables a 
physical machine to host several different virtual machines — the hypervisor allocates the resources 
for the VM. 


Virtualbox ? “VirtualBox is a general-purpose full virtualizer for x86 hardware, targeted at server, 
desktop and embedded use. “ 


Read more here > 
1. https://en.wikipedia.org/wiki/Virtual_machine 
2. https://en.wikipedia.org/wiki/Hypervisor 


3. https://www. virtualbox.org/wiki/VirtualBox 


Troubleshooting 


Commands 


1. Display all images on your machine : 
1. docker images or ‘docker image Is’ 
2. Remove an image (using ‘-f” for force in this case) 
1. docker rmi -f «image»? 
2. remove image-'hello-world' : docker rmi -f hello-world 
3. Display all containers running on your machine 
1. docker ps or ‘docker container Is’ 
4. Display all *docker networks' on your machine 
1. docker network Is 
5. Inspect a docker network on your machine 


1. docker network inspect <network-name> 


Resources 


Bioinfo fika 


© https://sites.google.com/site/msInrm/bioinfofika/bioinfofikawed28febdocker 


Wikipedia: On ‘Virtual Machine’ , Hypervisor and Kernel 

© https://en.wikipedia.org/wiki/Virtual_machine 

© https://en.wikipedia.org/wiki/Hypervisor 

© https://en.wikipedia.org/wiki/Kernel_(operating_system) 
Docker Page: 

© https://hub.docker.com/ 

© https://www.docker.com/ 

© https://www.docker.com/docker-community 


© https://docs.docker.com/get-started/#test-docker-version 


The MySQL Sakila-database: 
© https://dev.mysql.com/doc/sakila/en/sakila-installation.html 


© https://dev.mysql.com/doc/index-other.html (see Example Databases) 


Udemy 
A good online course at Udemy : “Docker Mastery: The Complete Toolset From a Docker“ . 
Price today, ca 12 Euro. 40.0008 students have enrolled (Numbers from 2018-02-27) 


https://www.udemy.com/docker-mastery/ by Bret Fisher (https://www.bretfisher.com/) 


